---
title: Overview
---

Welcome to the Droidrun Guides! This section provides step-by-step instructions and best practices for using Droidrun. Each guide focuses on a specific aspect of the framework, from device setup to advanced automation patterns.

---

## Available Guides

### Getting Started

**[CLI Reference](./cli)** - Complete command-line interface guide
- All CLI commands (`run`, `setup`, `devices`, `connect`, `ping`, `macro`)
- Configuration overrides and flags
- Environment variables and API keys
- Common workflows and troubleshooting

**[Device Setup](./device-setup)** - Set up Android and iOS devices
- Portal app installation and configuration
- Accessibility service enablement
- TCP vs Content Provider communication
- Wireless debugging and multi-device management

**[Configuration System](/sdk/configuration)** - Master the config-driven architecture
- YAML configuration structure
- LLM profiles per agent (Manager, Executor, CodeAct, Scripter)
- Mixing LLM providers (OpenAI, Anthropic, Google, Ollama, DeepSeek)
- Safe execution, prompts, and app cards

---

### Templates

Explore real-world examples and starter projects in the [droidrun-examples repository](https://github.com/droidrun/droidrun-examples):

- **[LinkedInJobsScraper](https://github.com/droidrun/droidrun-examples/tree/main/LinkedInJobsScraper)** - Agentic workflow that searches LinkedIn for roles, evaluates matches, and prepares tailored applications
- **[LinkedInLeads](https://github.com/droidrun/droidrun-examples/tree/main/LinkedInLeads)** - End-to-end lead discovery and enrichment for LinkedIn companies and roles
- **[TwitterPost](https://github.com/droidrun/droidrun-examples/tree/main/TwitterPost)** - Finds trending topics, drafts posts, and generates images to publish on X/Twitter
- **[play2048](https://github.com/droidrun/droidrun-examples/tree/main/play2048)** - DroidAgent that plays the 2048 game on play2048.co

Each example includes a self-contained workflow with entrypoint, configuration, and sample data. See the [README](https://github.com/droidrun/droidrun-examples) for setup instructions and contribution guidelines.


---

Need help? Join our [Discord community](https://discord.gg/ZZbKEZZkwK) for support and discussions.
